home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / apdz10b.zip / APP-DIZ.DOC next >
Text File  |  1992-10-15  |  9KB  |  239 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.    ██████████                                 █████████
  15.    ██      ██                                 ██       ██   ██
  16.    ██      ██                                 ██       ██
  17.    ██████████  ██████████  ██████████         ██       ██   ██   ███████
  18.    ██      ██  ██      ██  ██      ██  █████  ██       ██   ██        ▄
  19.    ██      ██  ██      ██  ██      ██         ██       ██   ██    ▄ ▀
  20.    ██      ██  ██████████  ██████████         █████████     ██   ███████
  21.                ██          ██
  22.                ██          ██
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                         Apply-Diz by Dataware Software
  30.  
  31.                                  Version 1.0b
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                
  44.                                 
  45.                                 Copyright (C) 1992
  46.                                         by
  47.                                     Tom Carroll
  48.  
  49.  
  50.                                 All rights reserved
  51.  
  52.  
  53.  
  54.                                  The Data Shop BBS
  55.                                 (509)582-9493 (HST)
  56.                                    Kennewick, WA
  57.                               FIDO address (1:347/10)
  58.  
  59.                               MAGIC FILE NAME: APPDIZ
  60.     ┌──────────────┐
  61.     │ INTRODUCTION │
  62.     └──────────────┘
  63.  
  64.     Apply-Diz is a utility designed to ease the burden of sysops trying to 
  65.     describe files, that either had their descriptions lost in the process of
  66.     a file transfer, or they are old enough that you just can't remember.  It
  67.     places the burden of describing files back onto the users and authors that
  68.     upload files without a description file such as FILE_ID.DIZ or DESC.SDI in
  69.     which Apply-Diz will make a FILE_ID.DIZ from the user supplied description
  70.     and compress it into the archive.  Apply-Diz can automatically detect
  71.     archives by signature, and extract or compress into the archive based on
  72.     this signature, no more relying on file suffixes.
  73.     
  74.     Apply-Diz has two purposes, one is to enhance the service that some of the
  75.     larger BBS's offer by insuring no matter what kind of file or archive
  76.     received on their system, either uploaded by users, downloaded from another
  77.     BBS, or copied to the system from monthly mailings, Apply-Diz will make sure
  78.     that two descriptions exist for the archive, one in the PCBoard directory
  79.     format, and the other in a FILE_ID.DIZ. (one of the two has to exist, but
  80.     neither one is overwritten if they both exist.)  This is a very appealing
  81.     feature that other sysops will appreciate if they subscribe to your BBS and
  82.     download your files for use on their systems.
  83.  
  84.     Two is the major reason Apply-Diz was invented.  I run a BBS, and I really
  85.     don't have all the time in the world to mess around with file descriptions,
  86.     and since I'm a programmer I tend to hold on to old archives, and then
  87.     forget what they were.  So I decided to cut half my workload and just write
  88.     a utility.
  89.     
  90.     You're probably asking your self "What is this guy babbling about?"  Well,
  91.     it's time to cut to the chase and show you how to operate it...
  92.  
  93.     ┌──────────────┐
  94.     │  DISCLAIMER  │
  95.     └──────────────┘
  96.  
  97.     This software is provided as is without warranty or guarantee either
  98.     expressed or implied.  The author will not be held responsible for ANY
  99.     damages that may result in the use of this program, including revenues
  100.     lost.  The Author will, however, be responsible for a full refund of the
  101.     purchasers registration cost should the software not be capable of
  102.     operating on the purchasers computer.
  103.  
  104.     Apply-Diz software and this document are Copyright (C) 1992 by Tom Carroll. 
  105.     All rights reserved.
  106.  
  107.     ┌──────────────┐
  108.     │   LICENSE    │
  109.     └──────────────┘
  110.  
  111.     This program is released as SHAREWARE.
  112.     
  113.     You are free to use this version of the program for a period of 30 days,
  114.     upon which, you must either register the software, or delete it from your
  115.     system with the exception of the original archive, which may be freely
  116.     distributed as outlined below.  Please refer to the ORDER.FRM included in
  117.     the distribution archive for registration information.
  118.  
  119.     Apply-Diz v1.0b                                                      Page 2
  120.     No one may alter, modify, or reverse engineer Apply-Diz for any reason,
  121.     including but not limited to decompiling-compiling, patching, or
  122.     disassembling.
  123.  
  124.     You may freely distribute & copy this program for others subject to the
  125.     above restrictions and the following:
  126.  
  127.          ■ Apply-Diz is copied in unmodified form including this file. 
  128.          ■ There is no charge for copying except for the cost of disks.
  129.          ■ Apply-Diz is not included in another software package without
  130.            the express written permission of Tom Carroll
  131.  
  132.     You may operate Apply-Diz on one computer system at a time, one computer
  133.     system is defined as a single XT/AT/PC which operates solely by itself, or
  134.     multi-node BBS running the same BBS software and all nodes are connected
  135.     to a central file server.
  136.  
  137.     Should Apply-Diz need to be operated on more that one computer system, then
  138.     a site license will be negotiated.
  139.  
  140.     ┌──────────────┐
  141.     │   SUPPORT    │
  142.     └──────────────┘
  143.  
  144.     If you should find any problems with this program, or you have any requests
  145.     or recommendations, you may reach me on my BBS, or at the FIDO address
  146.     listed on the front cover.  I may also be reached in the QUIK_BAS & PCBNET
  147.     FIDO echo's.
  148.  
  149.     ┌──────────────┐
  150.     │    FILES     │
  151.     └──────────────┘
  152.  
  153.     Files included in this archive:
  154.  
  155.               APP-DIZ.DOC - This manual
  156.               APP-DIZ.EXE - The Apply-Diz executable
  157.               APP-DIZ.HIS - Apply-Diz History information file
  158.               FILE_ID.DIZ - Description file for Apply-Diz
  159.               ORDER.FRM   - Registration form & ordering info
  160.  
  161.     I originally compressed this program as APDZnn.ARJ, but it may be
  162.     compressed with any other archive program you wish to use.
  163.  
  164.     The latest version will always be available on my BBS using the magic
  165.     filename of APPDIZ.
  166.  
  167.     Sometimes, there may be a need for debug code to be released.  This code is
  168.     used to track down specific problems which aren't normally encountered on
  169.     my system.  I have a 386/sx-25 w/4megs of RAM, and DOS 5.0, which should be
  170.     pretty standard and generic, but sometimes this doesn't present an
  171.     optimal testing environment, so please, if you're having problems, and debug
  172.     code is available, feel free to FREQ APDEBUG from me, or if you're
  173.     registered on my BBS call and download APPDIZ.ARJ from conference #1.  If
  174.     it's not available, then you're the first person that has reported a
  175.     problem, so please leave me your specifics so I may be able to trouble shoot
  176.     the problem(s).
  177.     
  178.     
  179.     Apply-Diz v1.0b                                                      Page 3
  180.  
  181.     ┌──────────────┐
  182.     │  EXECUTION   │
  183.     └──────────────┘
  184.  
  185.     Apply-Diz is fully command line driven.
  186.  
  187.     The syntax for calling it is as follows:
  188.  
  189.     APP-DIZ <ARCHIVE> <PCBDIRLIST>
  190.  
  191.     <ARCHIVE> = Full path and filename(s) of the archive to be processed.
  192.  
  193.     <PCBDIRLIST> = Full PCBoard file directory listing to be processed.
  194.  
  195.     ┌──────────────┐
  196.     │    NOTES     │
  197.     └──────────────┘
  198.  
  199.     At anytime, you may just type APP-DIZ without any command line arguments
  200.     and a help screen similar to this one will appear.
  201.     
  202.     In the registered version of App-Diz you may specify wild cards on the
  203.     command line for a the processing of all files in one directory.
  204.  
  205.     If you are using an unregistered evaluation copy, insure you have the
  206.     proper command line specified if you run this utility in your nightly event
  207.     because there is a pause that requires input from the keyboard.  This only
  208.     occurs if no arguments are given on the command line.
  209.  
  210.     Also, the unregistered version will append the the last line of the PCBoard
  211.     file description with "Apply-Diz (EVALUATION COPY)".  This is only appended
  212.     to the PCBoard file listings, and not added to the FILE_ID.DIZ.
  213.  
  214.     Any description lines in the PCBoard directory that begin with "Files:" or
  215.     "Received by" will be filtered out when making a FILE_ID.DIZ file.
  216.     
  217.     ┌──────────────┐
  218.     │ LIMITATIONS  │
  219.     └──────────────┘
  220.  
  221.     Apply-Diz is NOT Desqview aware, or capable of working with locked files.
  222.  
  223.     You must have the following archiver's for the defined archive types in your
  224.     path in order for App-Diz to operate correctly:
  225.  
  226.     ARC - PKPAK by PKWare Inc.
  227.     ARJ - ARJ by Robert K. Jung
  228.     LHA - LHARC by Haruyasu Yoshizaki
  229.     PAK - PAK by NoGate Consulting
  230.     ZIP - PKZip by PKWare Inc.
  231.     ZOO - ZOO by Rahul Dhesi
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.     Apply-Diz v1.0b                                                      Page 4
  239.